home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / mac / files / infodata / callbook.tar / callbook_1.3 / README < prev    next >
Text File  |  1991-03-31  |  3KB  |  53 lines
  1. Due to a number of requests I'm releasing these sources. They are not in
  2. the greatest of shape and certainly shouldn't be used to teach a course
  3. in programming style, but they do work quite well.
  4.  
  5. The TODO file contains things I've been meaning to do for a while. If
  6. anyone does any of them, please let me know. If you'd like to talk it
  7. over before implementing, just drop me a line. I've thought most of them
  8. through, but just don't have time to type them in.
  9.  
  10. There is very little in the way of documentation for this. If you're not
  11. up on network programming, you'll have to learn a bit on your own before
  12. plugging this in. This system consists of four programs; hash, endian,
  13. callbook and canadian.
  14.  
  15. There is a large comment at the start of hash.c that explains how to
  16. generate hash files for the database. The code is also short so you should
  17. be able to resolve any conflict by reading the code.
  18.  
  19. The endian program just flips the byte ordering in the hash tables. I
  20. needed to do this because our server (marvin) doesn't have enough swap
  21. space to build the hash tables so they needed to be built on a different
  22. machine. Since the two machines had a different byte ordering, I had to
  23. write the endian program to flip the bytes around for marvin.
  24.  
  25. Of course, the callbook program is the server itself. It expects the
  26. telnet protocol on stdin which is ideal if you want to run it out of
  27. inetd.
  28.  
  29. And the canadian program is for translating the DOC format database into
  30. the format that Rusty distributes so this server may read it. This program
  31. is basically an AI (read "guessing") program that tries to parse the DOCs
  32. very loose format and build as good of a strict FCC format as possible.
  33. Since a lot of the code is just guessing, I don't guarentee that all the
  34. entries get converted properly but initial estimates show that over 99%
  35. do. Copies of this database that have already been translated are available
  36. from ftp.cs.buffalo.edu.
  37.  
  38. Personally, I like to merge the US and Canadian databases by just cat'ing
  39. them together. Then I sort them according to last name with the command
  40.  
  41.     sort -b -d -f -t\| +1 -o callsign.sort -T tmp callsign
  42.  
  43. Of course, this take a long time and a *lot* of disk space. If you choose
  44. to organize your database the same way be prepared to have at least 100 Meg
  45. of disk space handy. Not sorting this way will work fine, too. The only
  46. advantage to sorting is that the entries will then be printed to the user
  47. in the order they are sorted.
  48.  
  49. Good luck and feel free to send any fixes/comments/questions to me at
  50. the address below. 73...
  51.  
  52. Sun Mar 31 13:46:19 EST 1991    bowen@cs.buffalo.edu
  53.